home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / mus / misc / ahiusr.readme < prev    next >
Text File  |  1997-05-03  |  8KB  |  196 lines
  1. Short:    Retagetable audio v4, User's Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     mus/misc
  5.  
  6. TITLE
  7.  
  8.      AHI Audio System
  9.  
  10. VERSION
  11.  
  12.      Release 4
  13.  
  14. AUTHOR
  15.  
  16.      Martin Blom <lcs@lysator.liu.se>
  17.  
  18. DESCRIPTION
  19.  
  20.      Retargetable Audio for AmigaOS
  21.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  22.  
  23.      (When refering to this software, the correct term is
  24.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  25.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  26.  
  27.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  28.      However, many features are lacking:
  29.  
  30.      · 16 bit samples are converted to 8 bits before they are mixed.
  31.      · No HiFi mixing routines are available.
  32.      · No stereo samples
  33.      · No DSP effects are available.
  34.      · Less precision on some calculations
  35.      · Slower
  36.  
  37.      As you can see, this version is very primitive.  Get yourself an
  38.      accelerator!  I cannot guarantee that I will continue to support this
  39.      processor in the future.
  40.  
  41.      Quick overview
  42.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  43.  
  44.      * Driver based
  45.  
  46.      Each supported sound card is controlled by a library-based audio
  47.      driver. For a 'dumb' sound card, a new driver should be written in
  48.      a few hours. For a 'smart' sound card, it is possible to utilize an
  49.      on-board DSP, for example, to maximize performance and sound quality.
  50.      For sound cards with own DSP but little or no memory, it is possible
  51.      to use the main CPU to mix channels and do the post-processing
  52.      with the DSP. Available today are drivers for
  53.  
  54.      · Aura (sampler only)
  55.      · Delfina
  56.      · DraCo Motion
  57.      · Paula (8/14/14c bit)
  58.      · Prelude
  59.      · Toccata
  60.      · Wavetools
  61.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  62.  
  63.      * Fast, powerful mixing routines (yeah, right... haha)
  64.  
  65.      The device's mixing routines mix 8- or 16-bit signed samples, both
  66.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  67.      (with stereo panning if desired) data, using any number of channels
  68.      (as long as 'any' means less than 128...).  Tables can be used speed
  69.      the mixing up (especially when using 8-bit samples).  The samples can
  70.      have any length (including odd) and can have any number of loops.
  71.      
  72.      * Support for non-realtime mixing
  73.  
  74.      By providing a timing feature, it is possible to create high-
  75.      quality output even if the processing power is lacking, by saving
  76.      the output to disk, for example as an IFF AIFF or 8SXV file.
  77.      There are so-called HiFi mixing routines that can be used, which
  78.      use linear interpolation and gives 32 bit output.
  79.  
  80.      * Audio database
  81.  
  82.      Uses ID codes, much like Screenmode IDs, to select the many
  83.      parameters that can be set. The functions to access the audio
  84.      database are not too different from those in 'graphics.library'.
  85.      The device also features a requester to get an ID code from the
  86.      user.
  87.  
  88.      * Both high- and low-level protocol
  89.  
  90.      By acting both like a device and a library, AHI gives the programmer
  91.      a choice between full control and simplicity. The device API allows
  92.      several programs to use the audio hardware at the same time, and
  93.      the AUDIO: dos-device driver makes playing and recording sound very
  94.      simple for both the programmer and user.
  95.  
  96.      * Future Compatible
  97.  
  98.      When AmigaOS gets device-independent audio worth it's name, it should
  99.      not be too difficult to write a driver for AHI, allowing applications
  100.      using 'ahi.device' to automatically use the new OS interface. At
  101.      least I hope it wont.
  102.  
  103. SPECIAL REQUIREMENTS
  104.  
  105.      AmigaOS release 2.
  106.      MC68020 processor strongly recommended.
  107.  
  108. AVAILABILITY
  109.  
  110.      Aminet, for example:
  111.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  112.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  113.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  114.  
  115.      WWW:
  116.      http://www.lysator.liu.se/~lcs/ahi.html
  117.  
  118. PRICE
  119.  
  120.      Free. But if you use it in a shareware of commercial product,
  121.      I would like a registered copy for me and each of the audio driver
  122.      authors (this is merely a wish, you don't have to do it if you don't
  123.      think we deserve it). See the AHI User's Guide for more information.
  124.  
  125. DISTRIBUTABILITY
  126.  
  127.      Copyright ©1994-1997 Martin Blom.
  128.      Freely distributable in unmodified form.
  129.      See the AHI User's Guide for more information.
  130.  
  131.  
  132. ============================= Archive contents =============================
  133.  
  134. Original  Packed Ratio    Date     Time    Name
  135. -------- ------- ----- --------- --------  -------------
  136.      632     283 55.2% 20-Apr-97 18:13:06  AHI.info
  137.    35250    7875 77.6% 18-Apr-97 18:29:56 +AHI Install
  138.      709     363 48.8% 15-Apr-97 19:28:26 +AHI Install.info
  139.     4479    2113 52.8% 22-Apr-97 00:18:16 +ahiusr.readme
  140.      468     232 50.4% 15-Apr-97 19:28:26 +ahiusr.readme.info
  141.      628     280 55.4% 15-Apr-97 19:28:26 +BGUI.info
  142.   123588   69860 43.4% 20-Jan-97 16:35:16 +bgui.library
  143.      362     218 39.7% 21-Mar-97 21:00:00 +Install BGUI
  144.      736     367 50.1% 21-Mar-97 21:13:56 +Install BGUI.info
  145.     3700    1420 61.6% 20-Jan-97 15:20:14 +ReadMe-BETA
  146.      468     234 50.0% 21-Mar-97 20:52:20 +ReadMe-BETA.info
  147.      364     219 39.8% 21-Mar-97 20:13:22 +Copyright
  148.      468     233 50.2% 15-Apr-97 19:28:26 +Copyright.info
  149.    16249    6126 62.2% 22-Apr-97 00:15:20 +History
  150.      468     233 50.2% 15-Apr-97 19:28:26 +History.info
  151.       34      34  0.0% 21-Mar-97 21:11:36 +User's Guide
  152.      464     226 51.2% 15-Apr-97 19:28:26 +User's Guide.info
  153.     3356    2227 33.6% 14-Apr-97 03:06:34 +AddAudioModes
  154.     1622     706 56.4% 21-Apr-97 23:41:58 +ahi.cd
  155.     2706    1059 60.8% 21-Apr-97 23:34:32 +ahiprefs.cd
  156.      752     464 38.2% 21-Apr-97 23:42:10 +ahi.catalog
  157.     1440     817 43.2% 21-Apr-97 23:34:48 +ahiprefs.catalog
  158.      732     443 39.4% 21-Apr-97 23:42:08 +ahi.catalog
  159.     1518     836 44.9% 21-Apr-97 23:34:48 +ahiprefs.catalog
  160.      686     422 38.4% 21-Apr-97 23:42:10 +ahi.catalog
  161.     1444     751 47.9% 21-Apr-97 23:34:44 +ahiprefs.catalog
  162.     1595     728 54.3% 21-Apr-97 23:41:58 +NewCatalog.ct
  163.     2574    1071 58.3% 21-Apr-97 23:34:32 +NewPrefsCatalog.ct
  164.      612     380 37.9% 21-Apr-97 23:42:10 +ahi.catalog
  165.     1402     780 44.3% 21-Apr-97 23:34:44 +ahiprefs.catalog
  166.      770     449 41.6% 21-Apr-97 23:42:12 +ahi.catalog
  167.     1548     849 45.1% 21-Apr-97 23:34:46 +ahiprefs.catalog
  168.      732     430 41.2% 21-Apr-97 23:42:08 +ahi.catalog
  169.     1458     811 44.3% 21-Apr-97 23:34:46 +ahiprefs.catalog
  170.    43300   20240 53.2% 21-Apr-97 23:04:48 +ahi.device
  171.    38752   19158 50.5% 21-Apr-97 23:02:46 +ahi.device.000
  172.    13100    7131 45.5% 03-Feb-97 02:25:14 +delfina.audio
  173.     6456    3638 43.6% 21-Apr-97 23:37:28 +filesave.audio
  174.     6524    3678 43.6% 21-Apr-97 23:38:20 +filesave.audio.000
  175.     6164    3468 43.7% 17-Apr-97 01:05:30 +paula.audio
  176.     6196    3478 43.8% 17-Apr-97 01:05:28 +paula.audio.000
  177.     9048    4389 51.4% 21-Apr-97 18:22:42 +prelude.audio
  178.     5936    3165 46.6% 21-Apr-97 23:38:54 +toccata.audio
  179.     5992    3186 46.8% 21-Apr-97 23:39:28 +toccata.audio.000
  180.     3404    1911 43.8% 17-Jan-97 17:54:00 +wavetools.audio
  181.      612     171 72.0% 24-Jul-96 10:35:00 +DELFINA
  182.      556     181 67.4% 16-Apr-97 17:24:22 +FILESAVE
  183.     1336     260 80.5% 21-Feb-97 00:23:58 +PAULA
  184.      444     151 65.9% 21-Apr-97 18:22:42 +PRELUDE
  185.      588     167 71.5% 17-Apr-97 11:56:10 +TOCCATA
  186.      600     172 71.3% 20-Feb-97 10:05:34 +WAVETOOLS
  187.      160     121 24.3% 27-Mar-97 12:08:50 +AUDIO
  188.      466     251 46.1% 29-Jan-97 15:56:22 +AUDIO.info
  189.    36095   12613 65.0% 21-Apr-97 23:42:16 +ahi.guide
  190.     5568    3386 39.1% 09-Apr-97 01:54:48 +AHI-Handler
  191.    33040   17391 47.3% 18-Apr-97 18:43:08 +AHI
  192.      654     420 35.7% 18-Apr-97 18:43:08 +AHI.info
  193.       21      21  0.0% 22-Apr-97 00:24:04 +Version
  194. -------- ------- ----- --------- --------
  195.   439026  212286 51.6% 22-Apr-97 11:57:16   58 files
  196.